home *** CD-ROM | disk | FTP | other *** search
/ Internet Surfer 2.0 / Internet Surfer 2.0 (Wayzata Technology) (1996).iso / pc / text / mac / faqs.315 < prev    next >
Text File  |  1996-02-12  |  28KB  |  677 lines

  1. Frequently Asked Questions (FAQS);faqs.315
  2.  
  3.  
  4.  
  5. @finalout
  6.  
  7. @titlepage
  8. @title G++ FAQ
  9. @subtitle Frequently asked questions about the Gnu C++ compiler
  10. @sp 1
  11. @author Joe Buck
  12. @page
  13. @end titlepage
  14.  
  15. @node Top, getting g++, (dir), (dir)
  16. @unnumbered Preface
  17.  
  18. This is a list of frequently asked questions for g++ users; thanks to
  19. all those who sent suggestions for improvements.
  20.  
  21. I'm looking for new questions, better answers, or both.  One thing that's
  22. missing is a section on templates and template problems with g++; I'm
  23. looking for contributions on this score.
  24.  
  25. This FAQ is intended to supplement, not replace, Marshall Cline's
  26. excellent FAQ for comp.lang.c++.  Especially if g++ is the first C++
  27. compiler you've ever used, the question "How do I do <X> with g++?"
  28. is probably really "How do I do <X> in C++?".  You can obtain the
  29. C++ FAQ by anonymous FTP from sun.soe.clarkson.edu [128.153.12.3],
  30. in the file ~ftp/pub/C++/FAQ.  (There is also a mail server for that
  31. FAQ, but it seems to be broken).
  32.  
  33. @menu
  34. * getting g++::                 Obtaining Source Code
  35. * installation::                Installation Issues and Problems
  36. * User Problems::               User Problems
  37. * legalities::                  What are the rules for shipping code built with g++ and libg++?
  38. @end menu
  39.  
  40. @node getting g++, installation, Top, Top
  41. @chapter Obtaining Source Code
  42.  
  43. @menu
  44. * g++ for Unix::                How do I get a copy of g++ for Unix?
  45. * g++ for other platforms::     How do I get a copy of g++ for (some other platform)?
  46. * 1.x vs 2.x versions::         But I can only find g++-1.42!
  47. * latest versions::             What is the latest version of gcc, g++, and libg++?
  48. * should I upgrade?::           I have gcc-2.2.2 and libg++-2.2.  Should I upgrade to the new versions?
  49. @end menu
  50.  
  51. @node g++ for Unix, g++ for other platforms, getting g++, getting g++
  52. @section How do I get a copy of g++ for Unix?
  53.  
  54. First, you may already have it if you have gcc for your platform; see
  55. the answer to question 3.
  56.  
  57. If you're trying to find g++, you can get it by anonymous FTP, by
  58. anonymous UUCP, by buying a tape from the Free Software Foundation,
  59. or by getting it from a friend that has it.
  60.  
  61. Here is a list of anonymous FTP archive sites for Gnu software.
  62.  
  63. @example
  64. Japan: ftp.cs.titech.ac.jp, utsun.s.u-tokyo.ac.jp:ftpsync/prep
  65. Australia: archie.au:gnu
  66. Europe: src.doc.ic.ac.uk:gnu, ftp.informatik.tu-muenchen.de,
  67.     ftp.informatik.rwth-aachen.de:pub/gnu,
  68.     nic.funet.fi:pub/gnu, ugle.unit.no, isy.liu.se,
  69.     ftp.stacken.kth.se, sunic.sunet.se, ftp.win.tue.nl,
  70.     ftp.diku.dk, ftp.eunet.ch, archive.eu.net
  71. United States: wuarchive.wustl.edu, ftp.cs.widener.edu,
  72.     uxc.cso.uiuc.edu, col.hp.com, gatekeeper.dec.com:pub/GNU,
  73.     ftp.uu.net:packages/gnu
  74. @end example
  75.  
  76. The "official site" is prep.ai.mit.edu, but your transfer will probably
  77. go faster if you use one of the above machines.
  78.  
  79. Users of the HP Precision Architecture (HP-9000/7xx and HP-9000/8xx) may
  80. want to use the "2.3.1-u2" version available from the University of Utah,
  81. site jaguar.cs.utah.edu.  This version supports debugging provided that
  82. gas is used (you need the version of gas available from the same place)
  83. and has several bug fixes that weren't done in time for the 2.3.2
  84. release.  Precompiled binaries of gcc and gdb can also be obtained from
  85. that site.  Hopefully this will all be folded in to 2.4.
  86.  
  87. UUNET customers can get Gnu sources from UUNET via UUCP.  For information
  88. on how to order tapes from FSF, write to gnu@@prep.ai.mit.edu.
  89.  
  90. UUCP-only sites can get Gnu sources by "anonymous UUCP" from site
  91. "osu-cis" at Ohio State University.  You pay for the long-distance call
  92. to OSU; the price isn't too bad on weekends at 9600 bps.  Send mail to
  93. uucp@@cis.ohio-state.edu or osu-cis!uucp for more information.
  94.  
  95. OSU lines are often busy.  If you're in the USA, and are willing to spend
  96. more money, you can get sources via UUCP from UUNET using their 900 number:
  97. 1-900-GOT-SRCS (900 numbers don't work internationally).  You will be
  98. billed $0.50/minute by your phone company.
  99.  
  100. Don't forget to retrieve libg++ as well!
  101.  
  102. @node g++ for other platforms, 1.x vs 2.x versions, g++ for Unix, getting g++
  103. @section How do I get a copy of g++ for (some other platform)?
  104.  
  105. The standard gcc/g++ distribution includes VMS support.  Since the
  106. FSF people don't use VMS, it's likely to be somewhat less solid than
  107. the Unix version.  Precompiled copies of G++ and libg++ in VMS-installable
  108. form are available by FTP from mango.rsmas.miami.edu.
  109.  
  110. DJ Delorie has ported gcc/g++ to MS-DOS; this port is popularly known as
  111. "DJGPP" (the P's stand for "plus").  It can be found on many FTP archive
  112. sites; its "home" is on grape.ecs.clarkson.edu, directory
  113. ~ftp/pub/msdos/djgpp.  Make sure you're retrieving the current version,
  114. which should indicate that it is a port of gcc-2.2.2 (2.3.1 and 2.3.2 have
  115. been released since then, but I don't think the DOS port is done yet).  It
  116. is also available on site wuarchive.wustl.edu, in directory
  117. mirrors/msdos/djgpp, and many other places as well.
  118.  
  119. For information on Amiga ports of gcc/g++, retrieve the file
  120. /pub/gnu/MicrosPorts/Amiga from prep.ai.mit.edu, or write
  121. to Leonard Norrgard <vinsci@@nic.funet.fi>, who I hope won't be too upset
  122. that I mentioned his name here.
  123.  
  124. A port of gcc-2.3.1 to the Atari ST can be found on the site
  125. ``atari.archive.umich.edu'', under /atari/Gnustuff/Tos, along with many
  126. other Gnu programs.  See the FAQ for the Usenet group
  127. ``comp.sys.atari.st'' for more information.
  128.  
  129. There are two different ports of gcc-2.2.2 (and g++) to OS/2, the
  130. so-called EMX port, which requires a particular Unix emulator, and
  131. a port called ``gcc/2'', which runs native.  The latter port uses
  132. a rather buggy port of the BSD libc.  For more information ask
  133. around on comp.os.os2.programmer.  gcc/2 can be obtained by FTP
  134. from
  135.  
  136. @example
  137. ftp-os2.nmsu.edu (128.123.35.151) in /pub/os2/2.0/programming/gcc2-222
  138. luga.latrobe.edu.au (131.172.2.2) in /pub/os2/2.0/programming/gcc2-222
  139. @end example
  140.  
  141. Eberhard Mattes did the EMX port.  Tevor Lampre did the gcc/2 port.
  142. Their addresses are mattes@@azu.informatik.uni-stuttgart.de and
  143. mmtl@@cc.flinders.edu.au, repectively.
  144.  
  145. Because the legal policies of Apple threaten the long-term goals of FSF,
  146. as well as the concept of free software, no support will be lent to
  147. efforts to port Gnu software to Macintosh or other Apple hardware.
  148.  
  149. @node 1.x vs 2.x versions, latest versions, g++ for other platforms, getting g++
  150. @section But I can only find g++-1.42!
  151.  
  152. ``I keep hearing people talking about g++ 2.3.2 (or some other number
  153. starting with 2), but the latest version I can find is g++ 1.42.
  154. Where is it?''
  155.  
  156. As of gcc 2.0, C, C++, and Objective-C as well are all combined into a
  157. single distribution called gcc.  If you get gcc you already have g++.  The
  158. standard installation procedure for any gcc version 2 compiler will
  159. install the C++ compiler as well.
  160.  
  161. One could argue that we shouldn't even refer to "g++-2.x.y" but it's a
  162. convention.  It means "the C++ compiler included with gcc-2.x.y".
  163.  
  164. @menu
  165. * latest versions::             What is the latest version of gcc, g++, and libg++?
  166. @end menu
  167.  
  168. @node latest versions, should I upgrade?, 1.x vs 2.x versions, getting g++
  169. @section What is the latest version of gcc, g++, and libg++?
  170.  
  171. The latest "2.x" version of gcc/g++ is 2.3.2, released Nov 27, 1992.
  172. The latest version of libg++ is 2.3, released Dec 9, 1992.
  173.  
  174. For some non-Unix platforms, 2.2.2 may be the latest compiler that
  175. has been ported.  libg++ 2.3 will not compile with gcc-2.2.2.  Also,
  176. due to a newly introduced compiler bug, libg++ 2.2 will not compile
  177. with gcc-2.3.1 or gcc-2.3.2.
  178.  
  179. The latest "1.x" version of gcc is 1.42, and the latest "1.x" version of
  180. g++ is 1.42.0.
  181.  
  182. @node should I upgrade?,  , latest versions, getting g++
  183. @section I have gcc-2.2.2 and libg++-2.2.  Should I upgrade to the new versions?
  184.  
  185. Unfortunately, this question cannot be answered with a simple yes or no.
  186. gcc-2.3.x made some significant improvements in template support;
  187. however, at the same time, quite a few new bugs were introduced in
  188. 2.3.1, particularly in resolving of overloaded functions.  2.3.2 fixed
  189. some of them, but serious problems remain (for example, 2.3.2 cannot
  190. compile some perfectly correct code in libg++-2.2).  Given this, I would
  191. recommend that those not using templates wait for a more stable release
  192. (gcc-2.3.3 should be out soon).  If you're using templates and 2.2.2
  193. won't cut it for you, by all means upgrade.
  194.  
  195. @node installation, User Problems, getting g++, Top
  196. @chapter Installation Issues and Problems
  197.  
  198. @menu
  199. * gcc-2 + g++-1::               I can't build g++ 1.x.y with gcc-2.x.y!
  200. * what else do I need?::        OK, I've obtained gcc; what else do I need?
  201. * use Gnu linker?::             Should I use the Gnu linker, or should I use "collect"?
  202. * Use Gnu assembler?::          Should I use the Gnu assembler, or my vendor's assembler?
  203. * Use Gnu C library?::          Should I use the Gnu C library?
  204. * Problems building libg++ on Ultrix::  Problems building libg++ on Ultrix
  205. @end menu
  206.  
  207. @node gcc-2 + g++-1, what else do I need?, installation, installation
  208. @section I can't build g++ 1.x.y with gcc-2.x.y!
  209.  
  210. ``I obtained gcc-2.x.y and g++ 1.x.y and I'm trying to build it, but
  211. I'm having major problems.  What's going on?''
  212.  
  213. If you wish to build g++-1.42, you must obtain gcc-1.42 first.  The
  214. installation instructions for g++ version 1 leave a lot to be desired,
  215. unfortunately, and I would recommend that, unless you have a special
  216. reason for needing the 1.x compiler, that C++ users use g++-2.3.2, as it
  217. is the version that is being actively maintained.
  218.  
  219. There is no template support in g++-1.x, and it is generally much further
  220. away from the ANSI draft standard than g++-2.x is.
  221.  
  222. @node what else do I need?, use Gnu linker?, gcc-2 + g++-1, installation
  223. @section OK, I've obtained gcc; what else do I need?
  224.  
  225. First off, you'll want libg++ as you can do almost nothing without it
  226. (unless you replace it with some other class library).
  227.  
  228. Second, depending on your platform, you may need "gas", the Gnu assembler,
  229. or the Gnu linker (see next question).
  230.  
  231. @node use Gnu linker?, Use Gnu assembler?, what else do I need?, installation
  232. @section Should I use the Gnu linker, or should I use "collect"?
  233.  
  234. First off, for novices: special measures must be taken with C++ to arrange
  235. for the calling of constructors for global or static objects before the
  236. execution of your program, and for the calling of destructors at the end.
  237. (Exception: System VR3 and System VR4 linkers support user-defined
  238. segments; g++ on these systems requires neither the Gnu linker nor
  239. collect.  So if you have such a system, the answer is that you don't
  240. need either one).
  241.  
  242. If you have experience with AT&T's "cfront", this function is performed
  243. there by programs named "patch" or "munch".  With Gnu C++, it is performed
  244. either by the Gnu linker or by a program known as "collect".  The collect
  245. program is part of the gcc-2.x distribution; you can obtain the Gnu linker
  246. separately as part of the "binutils" package.
  247.  
  248. (To be technical, it's "collect2"; there were originally several
  249. alternative versions of collect, and this is the one that survived).
  250.  
  251. There are advantages and disadvantages to either choice.
  252.  
  253. Advantages of the Gnu linker:
  254.  
  255. It's faster than using collect -- collect basically runs the standard Unix
  256. linker on your program twice, inserting some extra code after the first
  257. pass to call the constructors.  This is a sizable time penalty for large
  258. programs.  The Gnu linker does not require this extra pass.
  259.  
  260. Gnu ld reports undefined symbols using their true names, not the mangled
  261. names.
  262.  
  263. If there are undefined symbols, Gnu ld reports which object file(s) refer to
  264. the undefined symbol(s).
  265.  
  266. Advantages of collect:
  267.  
  268. If your native linker supports shared libraries, you can use shared
  269. libraries with collect.  The Gnu linker does not (yet) support shared
  270. libraries.
  271.  
  272. The Gnu linker has not been ported to as many platforms as g++ has, so you
  273. may be forced to use collect.
  274.  
  275. If you use collect, you don't need to get something extra and figure out
  276. how to install it; the standard gcc installation procedure will do it for you.
  277.  
  278. In conclusion, I don't see a clear win for either alternative at this
  279. point.  Take your pick.
  280.  
  281. @node Use Gnu assembler?, Use Gnu C library?, use Gnu linker?, installation
  282. @section Should I use the Gnu assembler, or my vendor's assembler?
  283.  
  284. This depends on your platform and your decision about the Gnu linker.  For
  285. most platforms, you'll need to use gas if you use the Gnu linker.  For
  286. some platforms, you have no choice; check the gcc installation notes to
  287. see whether you must use gas.  But you can usually use the vendor's
  288. assembler if you don't use the Gnu linker.
  289.  
  290. The Gnu assembler assembles faster than many native assemblers; however,
  291. on many platforms it cannot support the local debugging format.
  292.  
  293. @node Use Gnu C library?, Problems building libg++ on Ultrix, Use Gnu assembler?, installation
  294. @section Should I use the Gnu C library?
  295.  
  296. At this point in time, no.  The Gnu C library is still very young, and
  297. libg++ still conflicts with it in some places.  Use your native C library
  298. unless you know a lot about the gory details of libg++ and gnu-libc.  This
  299. will probably change in the future.
  300.  
  301. @node Problems building libg++ on Ultrix,  , Use Gnu C library?, installation
  302. @section Problems building libg++ on Ultrix
  303.  
  304. ``I am having trouble building libg++-2.2 on Ultrix [and possibly other
  305. systems].  I get errors referring to "dummy.o".  Help!''
  306.  
  307. (The errors on Ultrix end with something like
  308.  
  309. @example
  310. ldopen: cannot open dummy.o
  311. nm: Error: cannot open dummy.o
  312. ldopen: cannot open dummy.o
  313. nm: Error: cannot open dummy.o
  314. nm failed to find FUNC in dummy.o!
  315. sh: -1: bad number
  316. *** Error code 1
  317. @end example
  318.  
  319. @noindent
  320. and there may be similar problems on other systems).
  321.  
  322. The fix for this is to make libg++ by saying "make CC=gcc".
  323.  
  324. @node User Problems, legalities, installation, Top
  325. @chapter User Problems
  326.  
  327. @menu
  328. * static data members::         Linker reports undefined symbols for static data members
  329. * placement new syntax::        g++ won't accept the placement new syntax.
  330. * bug reports::                 I think I have found a bug in g++.
  331. * porting to g++::              Porting programs from other compilers to g++
  332. * name mangling::               Why does g++ mangle names differently from other C++ compilers?
  333. * problems linking with other libraries::  Why can't g++ code link with code from other C++ compilers?
  334. * documentation::               What documentation exists for g++ 2.x?
  335. * agreement with standards::    What are the differences between g++ and the ARM specification of C++?
  336. * compiling standard libraries::  Will g++ compile InterViews?  The NIH class library?
  337. * debugging on SVR4 systems::   Debugging on SVR4 systems
  338. @end menu
  339.  
  340. @node static data members, placement new syntax, User Problems, User Problems
  341. @section Linker reports undefined symbols for static data members
  342.  
  343. ``g++ reports undefined symbols for all my static data members when I link,
  344. even though the program works correctly for compiler XYZ.  What's going on?''
  345.  
  346. The problem is almost certainly that you don't give definitions for
  347. your static data members.  If you have
  348.  
  349. @example
  350. class Foo @{
  351.     ...
  352.     void method();
  353.     static int bar;
  354. @};
  355. @end example
  356.  
  357. you have only declared that there is an int named Foo::bar and a member
  358. function named Foo::method that is defined somewhere.  You still need to
  359. defined BOTH method() and bar in some source file.  According to the draft
  360. ANSI standard, you must supply an initializer, such as
  361.  
  362. @example
  363. int Foo::bar = 0;
  364. @end example
  365.  
  366. @noindent
  367. in one (and only one) source file.
  368.  
  369. @node placement new syntax, bug reports, static data members, User Problems
  370. @section g++ won't accept the placement new syntax.
  371.  
  372. ``I have a program that uses the "placement syntax" of operator new,
  373. e.g.
  374.  
  375. @example
  376.    new (somewhere) T;
  377. @end example
  378.  
  379. @noindent
  380. and g++ won't accept it.''
  381.  
  382. Up until version 2.3.1, g++ accepted an alternate form of the placement
  383. syntax, for historical reasons; use
  384.  
  385. @example
  386.    new @{somewhere@} T;
  387. @end example
  388.  
  389. @noindent
  390. if you are using g++-2.2.2 or older.
  391.  
  392. As of 2.3.1, g++ finally fixed this, using the standard ARM syntax for
  393. "placement new".  A few remaining glitches were fixed in 2.3.2.  The
  394. only remaining problem is with declarators for pointers to functions;
  395.  
  396. @example
  397. new (void (*)(int));  // confuses gcc 2.3.2
  398. new (a) (void (*)(int)); // ditto
  399. @end example
  400.  
  401. These can be worked around with a typedef:
  402.  
  403. @example
  404. typedef void (*fun)(int);
  405. new fun;
  406. new (a) fun;
  407. @end example
  408.  
  409. @node bug reports, porting to g++, placement new syntax, User Problems
  410. @section I think I have found a bug in g++.
  411.  
  412. ``I think I have found a bug in g++, but I'm not sure.  How do I know,
  413. and who should I tell?''
  414.  
  415. First, see the excellent section on bugs and bug reports in the gcc manual
  416. (which is included in the gcc distribution).  As a short summary of that
  417. section: if the compiler gets a fatal signal, for any input, it's a bug.
  418. Same thing for producing invalid assembly code.
  419.  
  420. I will add some extra notes that are C++-specific, since the notes from
  421. gcc are generally C-specific.
  422.  
  423. First, mail your bug report to "bug-g++@@prep.ai.mit.edu".  You may also
  424. post to gnu.bug.g++, but it's better to use mail, particularly if you
  425. any doubt as to whether your news software generates correct reply
  426. addresses.  Don't mail C++ bugs to bug-gcc@@prep.ai.mit.edu.
  427.  
  428. If your bug involves libg++ rather than the compiler, mail to
  429. bug-libg++@@prep.ai.mit.edu.  If you're not sure, you could send your bug
  430. to both lists.
  431.  
  432. Second, if your program does one thing, and you think it should do
  433. something else, it is best to consult a good reference if in doubt.  The
  434. standard reference is "The Annotated C++ Reference Manual", by Ellis and
  435. Stroustrup (copyright 1990, ISBN #0-201-51459-1); the reference manual,
  436. without annotations, also appears in Stroustrup's "The C++ Programming
  437. Language, Second Edition" (copyright 1991, ISBN #0-201-53992-6).  Both are
  438. published by Addison-Wesley.
  439.  
  440. Note that the behavior of (any version of) AT&T's "cfront" compiler is
  441. NOT the standard for the language.
  442.  
  443. @node porting to g++, name mangling, bug reports, User Problems
  444. @section Porting programs from other compilers to g++
  445.  
  446. ``I have a program that runs on <some other C++ compiler>, and I want
  447. to get it running under g++.  Is there anything I should watch out
  448. for?''
  449.  
  450. First, see the questions on placement new syntax and static data members.
  451.  
  452. There are two other reasons why a program that worked under one compiler
  453. might fail under another: your program may depend on the order of
  454. evaluation of side effects in an expression, or it may depend on the
  455. lifetime of a temporary (you may be assuming that a temporary object
  456. "lives" longer than the standard guarantees).  As an example of the
  457. first:
  458.  
  459.     void func(int,int);
  460.  
  461.     int i = 3;
  462.     func(i++,i++);
  463.  
  464. Novice programmers think that the increments will be evaluated in strict
  465. left-to-right order.  Neither C nor C++ guarantees this; the second
  466. increment might happen first, for example.  func might get 3,4, or it
  467. might get 4,3.
  468.  
  469. The second problem often happens with classes like the libg++ String
  470. class.  Let's say I have
  471.  
  472. String func1();
  473. void func2(const char*);
  474.  
  475. and I say
  476.  
  477.     func2(func1());
  478.  
  479. because I know that class String has an "operator const char*".  So what
  480. really happens is
  481.  
  482.     func2(func1().convert());
  483.  
  484. where I'm pretending I have a convert() method that is the same as the
  485. cast.  This is unsafe, because the temporary String object may be deleted
  486. after its last use (the call to the conversion function), leaving the
  487. pointer pointing to garbage, so by the time func2 is called, it gets an
  488. invalid argument.
  489.  
  490. If you think this is ugly, you should know that the ANSI C++ committee is
  491. STILL debating the lifetime-of-temporaries problem.
  492.  
  493. For now, the safe way to write such code is to give the temporary a name,
  494. which forces it to live until the end of the scope of the name. For
  495. example:
  496.  
  497.     String& tmp = func1();
  498.     func2(tmp);
  499.  
  500. Finally, like all compilers (but especially C++ compilers, it seems),
  501. g++ has bugs, and you may have tweaked one.
  502.  
  503. @node name mangling, problems linking with other libraries, porting to g++, User Problems
  504. @section Why does g++ mangle names differently from other C++ compilers?
  505.  
  506. See the answer to the next question.
  507.  
  508. @node problems linking with other libraries, documentation, name mangling, User Problems
  509. @section Why can't g++ code link with code from other C++ compilers?
  510.  
  511. ``Why can't I link g++-compiled programs against libraries compiled by
  512. some other C++ compiler?''
  513.  
  514. Some people think that, if only the FSF and Cygnus folks would stop being
  515. stubborn and mangle names the same way that, say, cfront does, then any
  516. g++-compiled program would link successfully against any cfront-compiled
  517. library and vice versa.  Name mangling is the least of the problems.
  518. Compilers differ as to how objects are laid out, how multiple inheritance
  519. is implemented, how virtual function calls are handled, and so on, so if
  520. the name mangling were made the same, your programs would link against
  521. libraries provided from other compilers but then crash when run.  For this
  522. reason, the ARM *encourages* compiler writers to make their name mangling
  523. different from that of other compilers for the same platform.
  524. Incompatible libraries are then detected at link time, rather than at run
  525. time.
  526.  
  527. @node documentation, agreement with standards, problems linking with other libraries, User Problems
  528. @section What documentation exists for g++ 2.x?
  529.  
  530. Almost none.  The gcc manual describes the C front end, and also the back
  531. end, which is shared by the C++ compiler, but there is almost no
  532. documentation for the C++ front end.  There is a Unix-style manual entry,
  533. "g++.1", in the gcc-2.x distribution; this describes the extra
  534. command-line options that g++ supports, and the #pragma interface and
  535. #pragma implementation directives.
  536.  
  537. A draft of a document describing the g++ internals appears in the 2.3.2
  538. distribution (called g++int.texi); it is still incomplete.
  539.  
  540. Work is proceeding on a user g++ document; with luck it will appear in the
  541. next release.
  542.  
  543. @node agreement with standards, compiling standard libraries, documentation, User Problems
  544. @section What are the differences between g++ and the ARM specification of C++?
  545.  
  546. The chief thing missing from g++ that is in the ARM is exceptions (the
  547. other major compilers do not have exceptions either).  There are bits
  548. and pieces of exception code present, but it is not presently usable.
  549.  
  550. While, as of 2.3.1, the "placement new" syntax finally agrees with the
  551. ARM, there are still some problems with it.
  552.  
  553. The template implementation is still new.  The implementation in 2.3.2
  554. represents a considerable improvement over that of previous releases,
  555. however.  Still, it has many bugs.
  556.  
  557. g++ does not implement a separate pass to instantiate template functions
  558. and classes at this point; for this reason, it will not work, for the most
  559. part, to declare your template functions in one file and define them in
  560. another.  The compiler will need to see the entire definition of the
  561. function, and will generate a static copy of the function in each file
  562. in which it is used.
  563.  
  564. As with any beta-test compiler, there are bugs.  You can help improve
  565. the compiler by submitting detailed bug reports.
  566.  
  567. [A full bug list would be very long indeed, so I won't put one here.
  568. I may add a list of frequently-reported bugs and "non-bugs" like the
  569. static class members issue mentioned above].
  570.  
  571. @node compiling standard libraries, debugging on SVR4 systems, agreement with standards, User Problems
  572. @section Will g++ compile InterViews?  The NIH class library?
  573.  
  574. The NIH class library uses a non-portable, compiler-dependent hack
  575. to initialize itself, which makes life difficult for g++ users.
  576. It will not work without modification, and I don't know what modifications
  577. are required or whether anyone has done them successfully.
  578.  
  579. Brendan Kehoe of Cygnus is working on getting NIHCL to build with g++.
  580. He says, "The NIHCL release will hopefully contain patches to gcc 2.3 to
  581. let it build."
  582.  
  583. [ From Stienar Bang <steinarb@@idt.unit.no> ]
  584.  
  585. The C++ compiler part of gcc-2.3 (when released) *should* be able to
  586. compile InterViews release 3.1 (when released) out of the box (no
  587. patches required on either side).
  588.  
  589. [ Now that 2.3.1 is out, is this true? ]
  590.  
  591. @node debugging on SVR4 systems,  , compiling standard libraries, User Problems
  592. @section Debugging on SVR4 systems
  593.  
  594. ``When I use the -g flag on C++ code on a System V Release 4 system,
  595. I get lots of undefined symbols at link time.  Why?  Help!''
  596.  
  597. [From Ron Guilmette:]
  598. The changes needed to get the g++ front-end to generate proper DWARF style
  599. debugging information for System V Release 4 are not yet completed, nor
  600. will they be until g++ version 2.4 (at the earliest).
  601.  
  602. There is nothing that you (as an end-user) can do to correct this problem.
  603. (It is actually *many* problems, and they are all very complex.)  Until
  604. the g++ maintainers have time to fix this, you should simply *avoid* using
  605. the -g option when using g++ on SVR4.
  606.  
  607. @node legalities,  , User Problems, Top
  608. @chapter What are the rules for shipping code built with g++ and libg++?
  609.  
  610. ``Is it is possible to distribute programs for profit that are created
  611. with g++ and use the g++ libraries?''
  612.  
  613. I am not a lawyer, and this is not legal advice.  In any case, I have
  614. little interest in telling people how to violate the spirit of the
  615. Gnu licenses without violating the letter.  This section tells you
  616. how to comply with the intention of the Gnu licenses as best I understand
  617. them.
  618.  
  619. The FSF has no objection to your making money.  Its only interest is that
  620. source code to their programs, and libraries, and to modified versions of
  621. their programs and libraries, is always available.
  622.  
  623. The short answer is that you do not need to release the source to
  624. your program, but you can't just ship a stripped executable either.
  625.  
  626. Compiling your code with a Gnu compiler does not affect its copyright;
  627. it is still yours.  However, in order to ship code that links in a Gnu
  628. library such as libg++ there are certain rules you must follow.  The
  629. rules are described in the file COPYING.LIB that accompanies gcc
  630. distributions; it is also included in the libg++ distribution.
  631. See that file for the exact rules.  The agreement is called the
  632. Library Gnu Public License or LGPL.  It is much "looser" than the
  633. Gnu Public License, or GPL, that covers must Gnu programs.
  634.  
  635. Here's the deal: let's say that you use some version of libg++,
  636. completely unchanged, in your software, and you want to ship only
  637. a binary form of your code.  You can do this, but there are several
  638. special requirements.  If you want to use libg++ but ship only object
  639. code for your code, you have to ship source for libg++ (or ensure
  640. somehow that your customer already has the source for the exact
  641. version you are using), and ship your application in linkable form.
  642. You cannot forbid your customer from reverse-engineering or extending
  643. your program by exploiting its linkable form.
  644.  
  645. Furthermore, if you modify libg++ itself, you must provide source
  646. for your modifications (making a derived class does not count as
  647. modifying the library -- that is "a work that uses the library").
  648.  
  649. @page
  650. @contents
  651. @bye
  652. --
  653. Joe Buck    jbuck@ohm.berkeley.edu
  654. Xref: bloom-picayune.mit.edu comp.graphics:34039 news.answers:4741
  655. Path: bloom-picayune.mit.edu!enterpoop.mit.edu!hri.com!spool.mu.edu!sdd.hp.com!elroy.jpl.nasa.gov!ufo!grieggs
  656. From: grieggs@jpl-devvax.jpl.nasa.gov (John T. Grieggs)
  657. Newsgroups: comp.graphics,news.answers
  658. Subject: (21Dec92) comp.graphics Frequently Asked Questions (FAQ)
  659. Message-ID: <1992Dec21.170230.6139@jpl-devvax.jpl.nasa.gov>
  660. Date: 21 Dec 92 17:02:30 GMT
  661. Expires: Mon, 4 Jan 1993 17:02:30 GMT
  662. Sender: grieggs@jpl-devvax.jpl.nasa.gov (John T. Grieggs)
  663. Reply-To: grieggs <grieggs@jpl-devvax.jpl.nasa.gov>
  664. Followup-To: poster
  665. Organization: Jet Propulsion Laboratory, Pasadena, CA
  666. Lines: 886
  667. Approved: news-answers-request@MIT.edu
  668.  
  669. Archive-name: graphics/faq
  670.  
  671. This message is automatically posted once a week or so in an effort to
  672. cut down on the repetitive junk in comp.graphics.  It was last changed
  673. on 21Dec92.  If you have answers to other frequently asked questions that
  674. you would like included in this posting, please send me mail.  If you
  675. don't want to see this posting every week, please add the subject line
  676. to your kill file.  Thank you.
  677.